In der SQL.config befinden sich die Verbindungsinformationen für eEvolution zu seinen Datenbanken. Die SQL.config befindet sich normalerweise im Ausführungsverzeichnis von eEvolution und wird bei der Installation mit dem Installer automatisch erzeugt. Sie enthält i.d.R. zwei Beispieleinträge, einem für SQL-Server und einen für Oracle, welche dann entsprechend für die Referenzdatenbank und Kundendatenbank angepasst werden müssen.
SQL.config für SQL-Server einrichten ohne Windows Authentifizierung (SingleSignOn)
SQL.config für SQL-Server einrichten mit Windows Authentifizierung (SingleSignOn)
Information:
Werden bei der mit dem installer auch die Referenz- und/ oder Kundendatenbank mitinstalliert, werden diese in die sql.config automatisch eingetragen.
Die Beschreibung der einzelnen Parameter und ihre Bedeutung finden Sie direkt in der sql.config, wo Sie diese nachlesen können oder unter "" hier in der Hilfe.
Ein Eintrag für eine SQL-Server-Datenbank sieht dabei wie folgt aus:
<database name="DEMOEEVOLUTION">
<provider name="Sql" namespace="System.Data.SqlClient" assembly="" brand="8" />
<autocommit value="false" />
<named_parameters value="true" prefix="@" />
<multiple_connections value="false" />
<null_empty_strings value="true" />
<mars_supported value="false" />
<encoding value="unicode" />
<connection_init value= "SET ANSI_WARNINGS OFF;SET ANSI_NULLS ON" />
<connection_string value="database=DEMO;server=sqlserver" />
</database>
Es ist notwendig mindestens die folgenden Eigenschaften zu prüfen und ggf. anzupassen:
Hinweis:
Sie können einen beliebigen Namen wählen.
Beispiel
<connection_init value= "SET ANSI_WARNINGS OFF;SET ANSI_NULLS ON" /
<connection_init value= "" /
<encoding value="unicode" />: Diese Zeile muss für eine Datenbank in der sql.config enthalten sein, wenn es sich um eine auf Unicode umgestellte Datenbank handelt. Ist die Datenbanken dagegen NICHT auf Unicode umgestellt, so muss diese Zeile aus der sql.config für diese Datenbank entfernt werden
<reference_database value="true"/>: Durch das Hinzufügen oder setzen von diesem Parameter auf "true" wird eine Datenbank als Referenzdatenbank gekennzeichnet, wodurch diese Datenbank nur noch in der Datenbankauswahl für Referenzdatenbanken beim Datenbankabgleich und bei der Anmeldung an die Installation/Administration zur Verfügung steht. Es ist nicht mehr möglich sich mit anderen Modulen, wie z.B. der Auftragsverwaltung oder dem iReport an diese Datenbank anzumelden.
Hinweis
Haben Sie den Parameter bei keiner Datenbank gesetzt, stehen Ihnen alle Datenbanken in allen Modulen zur Verfügung.
<multiple_connections value="false" >: Der Parameter <multiple_connections value="false" > in der sql.config darf niemals auf "true" gesetzt werden, da eEvolution keine Mehrfachverbindungen unterstützt. Haben Sie in der SQL.config für eine Datenbank den Parameter auf "true" gesetzt, so können die Module daher nicht gestartet werden.
Verwenden Sie die Zugangsart "Windows Authentifizierung" oder "SingleSignOn" ist ein Zusatz in der sql.config erforderlich. Dieser ist im Beispiel rot markiert:
<database name="SingleSignOn">
<provider name="Sql" namespace="System.Data.SqlClient" assembly="" brand="8" />
<autocommit value="false" />
<named_parameters value="true" prefix="@" />
<multiple_connections value="false" />
<null_empty_strings value="true" />
<mars_supported value="false" />
<connection_string value="database=Single;server=sqlserver;Trusted_Connection=yes " />
</database>
Die Windows Authentifizierung funktioniert NICHT im Installationsmodul.
Die Windows Authentifizierung funktioniert nur unter der Voraussetzung, dass der Benutzer auf der Datenbank angelegt worden ist UND als eEvolution-Benutzer zur Verfügung steht, weitere Informationen zu diesem Thema finden Sie unter "Einrichtung von Single Sign On Benutzern"
Der Eintrag für eine Oracle-Datenbank in der SQL.config sieht wie folgt aus:
<database name="DEMO">
<provider name="Oracle" namespace="Oracle.DataAccess.Client" assembly="Oracle.DataAccess" brand="28"/>
<autocommit value="false"/>
<named_parameters value="true" prefix=":"/>
<multiple_connections value="false"/>
<connection_string value="Data Source=demo"/>
Es ist notwendig mindestens die folgenden Eigenschaften zu prüfen und ggf. anzupassen:
Hinweis:
Sie können einen beliebigen Namen wählen.
Data Source=“: Tragen Sie an dieser Stelle den Namen der einzubindenden Datenbank ein unter dem diese in der TNSNAMES von Oracle eingetragen ist.
Beispiel:
Eintrag in der TNSNAMES:
Demo =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = demo.ngroup.info)(PORT = 1521))
)
(CONNECT_DATA =
(SID = Demoeevo)
(SERVER = DEDICATED)
)
)
Geben Sie "Demo" als "Data Source" an, d.h. als <connection_string value="Data Source=demo"/>, verwenden Sie nicht die SID an dieser Stelle.
<reference_database value="true"/>: Durch das Hinzufügen oder setzen von diesem Parameter auf "true" wird eine Datenbank als Referenzdatenbank gekennzeichnet, wodurch diese Datenbank nur noch in der Datenbankauswahl für Referenzdatenbanken beim Datenbankabgleich und bei der Anmeldung an die Installation/Administration zur Verfügung steht. Es ist nicht mehr möglich sich mit anderen Modulen, wie z.B. der Auftragsverwaltung oder dem iReport an diese Datenbank anzumelden.
Hinweis
Haben Sie den Parameter bei keiner Datenbank gesetzt, stehen Ihnen alle Datenbanken in allen Modulen zur Verfügung.
<multiple_connections value="false" >: Der Parameter <multiple_connections value="false" > in der sql.config darf niemals auf "true" gesetzt werden, da eEvolution keine Mehrfachverbindungen unterstützt. Haben Sie in der SQL.config für eine Datenbank den Parameter auf "true" gesetzt, so können die Module daher nicht gestartet werden.
Ab der Version 8.0 von eEvolution hat sich der Eintrag in der sql.config für Oracle signifikant verändert, so dass der bisherige Eintrag aus einer älteren Version von eEvolution ( wie z.B. 5, 6 oder 7) angepasst werden muss und nicht einfach übernommen werden kann.
Einführung - Datenbankabgleich